W03-2. 포트 · 볼륨 · 네트워크 - 실습 가이드

3주차 실습: 포트 · 볼륨 · 네트워크

실습 목표 (45분)

  • 127.0.0.1 바인딩으로 누가 접속할 수 있는지 직접 확인한다.
  • 노트북 폴더를 nginx 에 연결해서 파일을 고치면 바로 반영되는 것을 본다.
  • 볼륨으로 PostgreSQL 데이터를 컨테이너 삭제 후에도 살려 둔다.
  • 사용자 정의 네트워크에서 컨테이너끼리 이름으로 통신한다.

시작 전 확인

  • Docker Desktop 실행 중 (Engine running)
  • 터미널: macOS → 터미널 / Windows → PowerShell
  • VS Code 설치 (사전 준비 4-2)
  • 오늘부터 폴더 경로가 들어가서 macOS 와 Windows 명령이 다른 곳이 있습니다. 표시를 잘 보세요.

실습 내용 시간
0 작업 폴더 준비 4분
1 포트: 누가 접속할 수 있나 6분
2 바인드 마운트: 내 폴더를 웹 서버에 8분
3 볼륨 기본 5분
4 볼륨으로 DB 데이터 지키기 9분
5 네트워크: 이름으로 찾아가기 8분
6 정리 5분

실습 0. 작업 폴더 준비

이번 주부터 이 스터디의 파일은 모두 docker-study 폴더에 모읍니다.

macOS:

mkdir -p ~/docker-study/site
cd ~/docker-study
pwd

출력 예시: /Users/내이름/docker-study

Windows (PowerShell):

New-Item -ItemType Directory -Force "$HOME\docker-study\site"
cd "$HOME\docker-study"
pwd

출력 예시: C:\Users\내이름\docker-study

이제 VS Code 를 열고 File(파일) → Open Folder(폴더 열기) 로 docker-study 폴더를 엽니다.
VS Code 왼쪽 탐색기에서 site 폴더에 index.html 파일을 새로 만들고 아래 내용을 붙여 넣은 뒤 저장(Ctrl+S / Cmd+S) 합니다.

<!doctype html>
<html lang="ko">
<head><meta charset="utf-8"><title>3주차 실습</title></head>
<body>
  <h1>내 노트북 폴더에서 온 페이지입니다</h1>
</body>
</html>
파일은 꼭 VS Code 로 만드세요

  • Windows PowerShell 의 Out-File, echo ... > 로 만들면 파일 맨 앞에 보이지 않는 글자(BOM)가 붙습니다. 실제로 확인해 보니 화면에  가 찍힙니다.
  • <meta charset="utf-8"> 이 없으면 한글이 깨집니다.

이후 모든 명령은 docker-study 폴더에서 실행합니다

터미널을 새로 열었다면 cd ~/docker-study (macOS) 또는 cd "$HOME\docker-study" (Windows) 부터 하세요.


실습 1. 포트: 누가 접속할 수 있나

컨테이너 두 개를 서로 다른 방식으로 띄웁니다.

docker run -d --name study-all   -p 8082:80           nginx:1.30-alpine
docker run -d --name study-local -p 127.0.0.1:8081:80 nginx:1.30-alpine
docker port study-all
docker port study-local

출력 예시:

80/tcp -> 0.0.0.0:8082
80/tcp -> [::]:8082
80/tcp -> 127.0.0.1:8081
컨테이너 열린 주소 뜻
study-all 0.0.0.0:8082 노트북의 모든 네트워크 주소에서 받음
study-local 127.0.0.1:8081 노트북 자기 자신(localhost)에서만 받음

1-1. 내 노트북의 IP 주소 확인

macOS:

ipconfig getifaddr en0

Windows (PowerShell):

ipconfig | Select-String "IPv4"

출력 예시: 192.168.0.11 같은 주소가 나옵니다. 여러 줄이면 Wi-Fi 쪽 주소를 씁니다.

macOS 에서 아무것도 안 나오면 유선 랜일 수 있습니다. ipconfig getifaddr en1 을 해 보세요.

1-2. 브라우저로 비교

아래 4개 주소를 브라우저로 열어 봅니다. 192.168.0.11 자리에는 1-1 에서 확인한 내 IP 를 넣습니다.

주소 결과
http://localhost:8082 ✅ 보임
http://192.168.0.11:8082 ✅ 보임 → 옆 사람도 이 주소로 내 서버에 접속할 수 있다는 뜻
http://localhost:8081 ✅ 보임
http://192.168.0.11:8081 ❌ 연결 안 됨 → 바깥에서는 막혀 있음
옆 사람과 해 보기 (선택)

옆 사람에게 내 IP 를 알려 주고 http://내IP:8082 에 접속해 보라고 하세요.
회사 Wi-Fi 나 PC 방화벽 설정에 따라 막힐 수도 있습니다. 막히면 위 표처럼 내 IP 로 내가 접속하는 것으로 확인해도 충분합니다.

1-3. 빈 포트 자동 배정 -P

docker run -d --name study-random -P nginx:1.30-alpine
docker port study-random

출력 예시: 번호는 그때그때 다릅니다.

80/tcp -> 0.0.0.0:32768

정리합니다.

docker rm -f study-all study-local study-random

실습 2. 바인드 마운트: 내 폴더를 웹 서버에

site 폴더를 nginx 의 웹 문서 폴더(/usr/share/nginx/html)에 읽기 전용으로 연결합니다.

macOS:

docker run -d --name study-site -p 8080:80 -v "$(pwd)/site:/usr/share/nginx/html:ro" nginx:1.30-alpine

Windows (PowerShell):

docker run -d --name study-site -p 8080:80 -v "${PWD}/site:/usr/share/nginx/html:ro" nginx:1.30-alpine
$(pwd) / ${PWD} 는 "지금 있는 폴더" 입니다

-v 에는 전체 경로를 줘야 합니다. 직접 타이핑하는 대신 현재 폴더 경로를 자동으로 넣어 주는 것입니다.
경로에 공백이나 한글이 있을 수 있으니 따옴표로 감싸는 것을 잊지 마세요. 한글 경로에서도 정상 동작하는 것을 확인했습니다.

2-1. 확인

http://localhost:8080 → "내 노트북 폴더에서 온 페이지입니다" 가 보이면 성공입니다.

2-2. 파일을 고치면 바로 반영된다

VS Code 에서 site/index.html 의 <h1> 내용을 아무렇게나 바꾸고 저장한 뒤, 브라우저를 새로고침합니다.

→ 컨테이너를 다시 만들지 않았는데 바뀐 내용이 바로 보입니다. 컨테이너가 내 폴더를 직접 보고 있기 때문입니다.

이것이 개발할 때 바인드 마운트를 쓰는 이유입니다

코드를 고칠 때마다 이미지를 새로 만들 필요 없이, 내 폴더를 연결해 두고 바로바로 확인합니다.

VS Code 에서 site 폴더에 about.html 파일을 하나 더 만들어 아무 내용이나 넣고 저장한 뒤 http://localhost:8080/about.html 도 열어 보세요.

2-3. 읽기 전용(:ro) 확인

컨테이너 안에서 파일을 만들어 봅니다.

docker exec study-site sh -c "echo hack > /usr/share/nginx/html/hack.html"

출력 예시:

sh: can't create /usr/share/nginx/html/hack.html: Read-only file system

컨테이너는 이 폴더를 읽기만 할 수 있습니다. 웹 서버가 공격당해도 원본 파일을 바꿀 수 없게 막는 안전장치입니다.

2-4. 연결 정보 확인

docker inspect --format "{{range .Mounts}}{{.Type}} | {{.Source}} -> {{.Destination}} | 쓰기가능={{.RW}}{{end}}" study-site

출력 예시 (Windows):

bind | C:\Users\내이름\docker-study/site -> /usr/share/nginx/html | 쓰기가능=false
docker rm -f study-site

컨테이너를 지워도 site 폴더와 파일은 내 노트북에 그대로 있습니다. VS Code 에서 확인해 보세요.


실습 3. 볼륨 기본

3-1. 볼륨 만들기

docker volume create study-data
docker volume ls --filter name=study-

출력 예시:

study-data
DRIVER    VOLUME NAME
local     study-data

3-2. 컨테이너 A 가 쓰고, 컨테이너 B 가 읽기

docker run --rm -v study-data:/data alpine:3.24 sh -c "date > /data/note.txt"
docker run --rm -v study-data:/data alpine:3.24 cat /data/note.txt

출력 예시:

Thu Oct  1 05:03:01 UTC 2026
두 컨테이너는 --rm 이라 실행이 끝나자마자 지워졌습니다.

그런데도 두 번째 컨테이너가 첫 번째 컨테이너가 쓴 내용을 읽었습니다. 데이터가 컨테이너가 아니라 볼륨에 있기 때문입니다.

3-3. 볼륨은 어디에 있나

docker volume inspect study-data --format "{{.Driver}} | {{.Mountpoint}}"

출력 예시:

local | /var/lib/docker/volumes/study-data/_data

이 경로는 노트북이 아니라 Docker Desktop 의 리눅스 VM 안 경로입니다. 그래서 Finder 나 탐색기로는 보이지 않습니다. 볼륨은 Docker 를 통해서 다루는 것이 원칙입니다.
Docker Desktop 대시보드의 Volumes 화면에서는 내용을 볼 수 있습니다.


실습 4. 볼륨으로 DB 데이터 지키기

4-1. PostgreSQL 실행 (볼륨 연결)

docker run -d --name study-db -e POSTGRES_PASSWORD=studypw -v study-pgdata:/var/lib/postgresql postgres:18-alpine
옵션 의미
-e POSTGRES_PASSWORD=studypw 환경 변수로 관리자 비밀번호를 넘김 (이 이미지는 이 값이 없으면 실행을 거부합니다)
-v study-pgdata:/var/lib/postgresql study-pgdata 볼륨을 DB 데이터 폴더에 연결 (없으면 자동으로 생성)
study-pgdata 볼륨은 만든 적이 없는데요?

-v 이름:경로 에서 그 이름의 볼륨이 없으면 Docker 가 알아서 만듭니다.

4-2. DB 가 준비될 때까지 기다리기

PostgreSQL 은 처음 실행할 때 초기화하느라 몇 초 걸립니다. 로그를 확인합니다.

docker logs --tail 2 study-db

출력 예시: 마지막 줄에 아래 문장이 보이면 준비 완료입니다.

... LOG:  database system was shut down at 2026-10-01 05:05:15 UTC
... LOG:  database system is ready to accept connections
너무 빨리 접속하면

psql: error: connection to server on socket "/var/run/postgresql/.s.PGSQL.5432" failed: No such file or directory

고장이 아니라 아직 준비 중이라는 뜻입니다. 5~10초 기다렸다가 다시 하세요.

4-3. 테이블을 만들고 데이터 넣기

docker exec study-db psql -U postgres -c "CREATE TABLE memo (id serial PRIMARY KEY, body text);"
docker exec study-db psql -U postgres -c "INSERT INTO memo (body) VALUES ('첫 번째 메모'), ('두 번째 메모');"
docker exec study-db psql -U postgres -c "SELECT * FROM memo;"

출력 예시:

CREATE TABLE
INSERT 0 2
 id |     body
----+--------------
  1 | 첫 번째 메모
  2 | 두 번째 메모
(2 rows)

psql 은 PostgreSQL 에 접속하는 명령 도구입니다. 이미지 안에 들어 있어서 노트북에 따로 설치할 필요가 없습니다.

4-4. DB 컨테이너를 지우고 다시 만들기

docker rm -f study-db
docker run -d --name study-db -e POSTGRES_PASSWORD=studypw -v study-pgdata:/var/lib/postgresql postgres:18-alpine

몇 초 기다린 뒤(4-2 처럼 로그 확인):

docker exec study-db psql -U postgres -c "SELECT * FROM memo;"

출력 예시:

 id |     body
----+--------------
  1 | 첫 번째 메모
  2 | 두 번째 메모
(2 rows)
데이터가 살아 있습니다! 🎉

컨테이너는 새것이지만 같은 볼륨을 연결했기 때문에 데이터가 그대로 있습니다.
"컨테이너는 언제든 버리고 새로 만들 수 있고, 데이터는 볼륨에 둔다" 가 컨테이너 운영의 기본 원칙입니다.

생각해 보기

-v 없이 DB 를 띄웠다면 어떻게 됐을까요? → 4-4 에서 컨테이너를 지우는 순간 메모가 모두 사라졌을 것입니다.


실습 5. 네트워크: 이름으로 찾아가기

5-1. 기본 네트워크에서는 이름을 못 찾는다

docker run -d --name study-web nginx:1.30-alpine
docker run --rm alpine:3.24 wget -qO- -T 3 http://study-web

출력 예시:

wget: bad address 'study-web'

wget 은 웹 페이지를 받아 오는 명령입니다. bad address 는 "study-web 이라는 이름의 주소를 모르겠다" 는 뜻입니다.

IP 로는 될까요?

docker inspect --format "{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}" study-web

출력 예시: 172.17.0.2

docker run --rm alpine:3.24 wget -qO- -T 3 http://172.17.0.2

172.17.0.2 자리에 위에서 나온 IP 를 넣으세요. nginx 페이지 HTML 이 출력됩니다.
IP 로는 되지만, 컨테이너를 다시 만들면 IP 가 바뀔 수 있어서 실무에서는 쓸 수 없습니다.

docker rm -f study-web

5-2. 사용자 정의 네트워크 만들기

docker network create study-net
docker network ls --filter name=study-

출력 예시:

8bf5df9a61d3ec6d...
NETWORK ID     NAME        DRIVER    SCOPE
8bf5df9a61d3   study-net   bridge    local

5-3. 같은 네트워크에서는 이름으로 접속

docker run -d --name study-web --network study-net nginx:1.30-alpine
docker run --rm --network study-net alpine:3.24 wget -qO- http://study-web

출력 예시: nginx 페이지 HTML 이 나옵니다.

<!DOCTYPE html>
<html>
<head>
<title>Welcome to nginx!</title>
...

이름이 어떤 IP 로 바뀌는지도 볼 수 있습니다.

docker run --rm --network study-net alpine:3.24 nslookup study-web

출력 예시 (끝부분):

Name:	study-web
Address: 172.24.0.2

Docker 의 내장 DNS 가 study-web → 172.24.0.2 로 바꿔 줍니다. 컨테이너를 다시 만들어 IP 가 바뀌어도 이름은 그대로 쓸 수 있습니다.

5-4. 웹 + DB 를 같은 네트워크로 (DB 포트는 공개하지 않음)

실습 4의 DB 를 지우고, 이번에는 study-net 에 연결해서 다시 띄웁니다. 같은 볼륨을 씁니다.

docker rm -f study-db
docker run -d --name study-db --network study-net -e POSTGRES_PASSWORD=studypw -v study-pgdata:/var/lib/postgresql postgres:18-alpine

몇 초 기다린 뒤, 다른 컨테이너에서 이름(study-db)으로 DB 에 접속합니다.

docker run --rm --network study-net -e PGPASSWORD=studypw postgres:18-alpine psql -h study-db -U postgres -c "SELECT * FROM memo;"

출력 예시:

 id |     body
----+--------------
  1 | 첫 번째 메모
  2 | 두 번째 메모
(2 rows)
확인할 점 의미
-h study-db IP 가 아니라 컨테이너 이름으로 DB 서버를 찾았습니다
DB 에 -p 를 주지 않았음 노트북 바깥에서는 DB 에 접근할 수 없습니다. 같은 네트워크의 컨테이너만 접속 가능합니다
데이터가 그대로 실습 4의 볼륨을 다시 연결했기 때문입니다
5주차 예고

지금 한 일(네트워크 만들기 → DB 띄우기 → 볼륨 연결 → 앱 띄우기)을 파일 하나에 적어 두고 명령 한 줄로 하는 것이 Docker Compose 입니다.

5-5. 다른 네트워크에서는 안 보인다

docker run --rm alpine:3.24 wget -qO- -T 3 http://study-web

출력 예시:

wget: bad address 'study-web'

--network 를 주지 않은 컨테이너(기본 네트워크)에서는 study-net 안의 컨테이너가 보이지 않습니다. 네트워크가 곧 격리의 경계입니다.


실습 6. 정리

6-1. 쓰는 중인 것은 지울 수 없다

docker volume rm study-pgdata
docker network rm study-net

출력 예시:

Error response from daemon: remove study-pgdata: volume is in use - [e4387d7720a3...]
Error response from daemon: error while removing network: network study-net has active endpoints (name:"study-web" id:"4ce42ada71a3", name:"study-db" id:"e2e5c3d61f37")

볼륨과 네트워크도 이미지처럼, 쓰는 컨테이너가 있으면 지울 수 없습니다.

6-2. 순서대로 정리

컨테이너 → 네트워크 → 볼륨 순서로 지웁니다.

docker rm -f study-web study-db
docker network rm study-net
docker volume rm study-data study-pgdata

확인합니다.

docker ps -a --filter name=study-
docker volume ls --filter name=study-
docker network ls --filter name=study-

세 목록이 모두 비어 있으면 정리 끝입니다. ✅

볼륨을 지우면 데이터가 영구히 사라집니다

컨테이너와 달리 볼륨 삭제는 되돌릴 수 없습니다. 실무에서는 docker volume rm 전에 꼭 한 번 더 확인하세요.
docker-study/site 폴더(바인드 마운트)는 다음 주에도 쓰지 않으니 남겨 둬도, 지워도 됩니다.


자주 나는 문제와 해결

증상 원인 해결
페이지에  가 보이거나 한글이 깨짐 PowerShell 로 파일을 만들었거나 <meta charset="utf-8"> 이 없음 VS Code 로 파일을 다시 만들고 meta 태그 확인
-v 로 연결했는데 nginx 가 403 Forbidden 연결한 폴더에 index.html 이 없음 (경로가 틀렸을 가능성) docker inspect 로 Source 경로 확인, 폴더 안에 파일이 있는지 확인
바인드 마운트 폴더가 비어 보임 docker-study 폴더가 아닌 곳에서 명령 실행 pwd 로 현재 위치 확인 후 cd
psql: error: connection to server on socket ... failed DB 가 아직 초기화 중 5~10초 뒤 다시 시도 (docker logs --tail 2 study-db 로 확인)
FATAL: password authentication failed for user "postgres" 같은 볼륨을 다른 비밀번호로 다시 씀 비밀번호는 볼륨을 처음 만들 때만 적용됩니다. 실습용이면 볼륨을 지우고 다시 시작
wget: bad address 두 컨테이너가 같은 사용자 정의 네트워크에 없음 둘 다 --network study-net 으로 실행했는지 확인
volume is in use / has active endpoints 쓰는 컨테이너가 남아 있음 컨테이너부터 지우기

오늘 쓴 명령어 정리

분류 명령어 하는 일
포트 -p 8080:80 / -p 127.0.0.1:8080:80 / -P 전체 공개 / 내 노트북만 / 자동 배정
docker port <이름> 포트 연결 확인
바인드 마운트 -v "$(pwd)/site:/경로:ro" (macOS)
-v "${PWD}/site:/경로:ro" (Windows)
현재 폴더 아래 site 를 연결 (읽기 전용)
볼륨 docker volume create / ls / inspect / rm 볼륨 관리
-v 볼륨이름:/경로 볼륨 연결 (없으면 자동 생성)
환경 변수 -e 이름=값 컨테이너에 설정 값 전달
네트워크 docker network create / ls / rm 네트워크 관리
--network 네트워크이름 그 네트워크에 연결해서 실행

복습 과제

확인 퀴즈

  1. -p 8080:80 과 -p 127.0.0.1:8080:80 의 차이는?
  2. 바인드 마운트와 볼륨은 각각 어떤 데이터에 쓰는 것이 좋을까요?
  3. 실습 4-4에서 DB 컨테이너를 지웠는데 메모가 남아 있었던 이유는?
  4. PostgreSQL 18 이미지에 볼륨을 연결할 컨테이너 쪽 경로는?
  5. 기본 네트워크에서 wget http://study-web 이 실패한 이유와 해결 방법은?
  6. 실습 5-4에서 DB 에 -p 를 주지 않은 이유는?

도전 과제 (선택)

  1. study-net 네트워크에 nginx 두 개(study-a, study-b)를 띄우고, study-a 안에서 wget -qO- http://study-b 가 되는지 확인해 보세요. (docker exec study-a wget -qO- http://study-b)
  2. 실행 중인 컨테이너를 나중에 네트워크에 붙일 수도 있습니다. docker network connect study-net <컨테이너이름> 을 찾아서 써 보세요.
  3. 다 했으면 실습 6처럼 컨테이너 → 네트워크 → 볼륨 순서로 정리합니다.
다음 주 예고: 4주차 Dockerfile 과 이미지 빌드

지금까지는 남이 만든 이미지(nginx, postgres)만 썼습니다. 다음 주에는 스터디 예제 앱 방명록(guestbook) 을 내 이미지로 직접 만들고, Docker Hub 에 올려서 다른 사람이 받아 쓸 수 있게 합니다.
Docker Hub 아이디와 비밀번호를 꼭 기억해 오세요.


네비게이션

이전 목록 다음
◀ 3주차 강의 노트 목록으로 4주차 강의 노트 ▶